home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / imgcopy.z / imgcopy
Encoding:
Text File  |  2002-10-03  |  11.7 KB  |  265 lines
  1.  
  2.  
  3.  
  4. IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))                                                          IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      imgcopy - copy and convert image file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiimmmmggggccccooooppppyyyy [----ffffformat] [----ttttdata_type] [----OOOOorder] [----ppppw,h,z,c] [----oooow,h,z,c]
  13.              [----ssssw,h,z,c] [----ccccorientation] [----CCCCcolor_model] [----PPPPcompression_type]
  14.              [----qqqqcompression_quality] [----mmmmminimum_value] [----MMMMmaximum_value] [----hhhh]
  15.              [----DDDD] [----nnnn#colors] [----aaaa] infile[::::index][####format][%%%%format_args]
  16.              outfile[####format][%%%%format_args]
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _i_m_g_c_o_p_y allows image files with formats supported by the ImageVision
  20.      Library to be copied and converted to other supported formats.  The
  21.      following command line options are allowed:
  22.  
  23.      ----ffff_f_o_r_m_a_t
  24.           Specifies the file format to convert to.  By default the output
  25.           image file format is based on the file name extension.  If the
  26.           extension is not of a known type, then the default file format will
  27.           be used (usually TIFF).  The supported file formats depend on what
  28.           ImageVision file formats have been installed; if an unknown format
  29.           is given the valid options will be listed.
  30.  
  31.      ----tttt_d_a_t_a__t_y_p_e
  32.           Specifies the data type to convert to.  By default the output image
  33.           file will use the input image's data type, if possible.  The data
  34.           type may be one of: bbbbiiiitttt, cccchhhhaaaarrrr, uuuucccchhhhaaaarrrr, sssshhhhoooorrrrtttt, uuuusssshhhhoooorrrrtttt, lllloooonnnngggg, uuuulllloooonnnngggg,
  35.           ffffllllooooaaaatttt and ddddoooouuuubbbblllleeee.
  36.  
  37.      ----OOOO_o_r_d_e_r
  38.           Specifies the ordering of dimensions of the created image.  May be
  39.           one of:  iiiinnnntttteeeerrrrlllleeeeaaaavvvveeeedddd (bands, samples, lines), sssseeeeqqqquuuueeeennnnttttiiiiaaaallll (samples,
  40.           bands, lines) or sssseeeeppppaaaarrrraaaatttteeee (samples, lines, bands).  By default the
  41.           output image file will have the same ordering as the input if the
  42.           selected image file format supports it.
  43.  
  44.      ----pppp_w,_h,_z,_c
  45.           Specifies the page size of the created image.  A default page size
  46.           will be computed if none is given.
  47.  
  48.      ----oooo_w,_h,_z,_c
  49.           Specifies the origin of a subregion to be copied from the input
  50.           image.  By default the entire image will be copied. This subregion
  51.           is specified in a coordinate system with its origin at the upper
  52.           left corner of the image progressing along the x axis towards the
  53.           lower right corner of the image.
  54.  
  55.      ----ssss_w,_h,_z,_c
  56.           Specifies the size of a subregion to be copied from the input image.
  57.           By default the entire image will be copied.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))                                                          IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))
  71.  
  72.  
  73.  
  74.      ----cccc_o_r_i_e_n_t_a_t_i_o_n
  75.           Specifies the orientation to convert to.  By default the output
  76.           image file will use the input image's orientation, if possible.  The
  77.           orientation may be one of: ttttllll, bbbbllll, ttttrrrr, bbbbrrrr, lllltttt, llllbbbb, rrrrtttt and rrrrbbbb.  Where
  78.           llll is left, rrrr is right, tttt is top and bbbb is bottom.
  79.  
  80.      ----CCCC_c_o_l_o_r__m_o_d_e_l
  81.           Specifies the color model to convert to.  By default the output
  82.           image file will use the input image's color model, if possible.  The
  83.           color model may be one of: rrrrggggbbbb, aaaabbbbggggrrrr, ggggrrrreeeeyyyy, nnnneeeeggggaaaattttiiiivvvveeee, ppppaaaalllleeeetttttttteeee, hhhhssssvvvv,
  84.           ccccmmmmyyyy and ccccmmmmyyyykkkk.
  85.  
  86.      ----PPPP_c_o_m_p_r_e_s_s_s_i_o_n__t_y_p_e
  87.           Specifies the type of compression to use in the output image file.
  88.           The compression may be one of:  nnnnoooonnnneeee, ffffaaaaxxxx3333, ffffaaaaxxxx4444, llllzzzzwwww, mmmmaaaaccccrrrrlllleeee,
  89.           ssssggggiiiirrrrlllleeee, jjjjppppeeeegggg or zzzziiiipppp
  90.  
  91.      ----qqqq_c_o_m_p_r_e_s_s_s_i_o_n__q_u_a_l_i_t_y
  92.           Specifies the quality of compression to use in the output image
  93.           file.  The value ranges from 0 (worst) to 100 (best). The default is
  94.           75.  Currently this is only meaninful when saving to a JFIF (.jpg)
  95.           file.
  96.  
  97.      ----mmmm_m_i_n_i_m_u_m__v_a_l_u_e
  98.           Specifies the minimum value to tag the output image with. No scaling
  99.           is implied; this option is mainly used to override input images with
  100.           invalid minimum values.  By default the output image file will use
  101.           the input image's minimum value.  This option overrides the -h
  102.           option.
  103.  
  104.      ----MMMM_m_a_x_i_m_u_m__v_a_l_u_e
  105.           Specifies the maximum value to tag the output image with. No scaling
  106.           is implied; this option is mainly used to override input images with
  107.           invalid maximum values.  By default the output image file will use
  108.           the input image's maximum value.  This option overrides the -h
  109.           option.
  110.  
  111.      ----hhhh   Specifies that the input image is to be histogrammed in order to
  112.           determine the minimum and maximum values to tag the output image
  113.           with. No scaling is implied; this option is mainly used to override
  114.           input images with invalid minimum and maximum values.  By default
  115.           the output image file will use the input image's minimum and maximum
  116.           values.  This option overrides the -m and -M options.
  117.  
  118.      ----DDDD   Specifies that ordererd dithering should be used instead of Floyd-
  119.           Steinberg dithering when converting to images with a palette type
  120.           color model.
  121.  
  122.      ----nnnn#_c_o_l_o_r_s
  123.           When doing Floyd-Steinberg dithering, the target number of entries
  124.           in the color map to be computes (using Heckbert's median-cut
  125.           algorithm).
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))                                                          IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))
  137.  
  138.  
  139.  
  140.      ----aaaa   Specifies that the input image is to be appended as a sub-image to
  141.           the output image. Only certain formats (like TIFF and GIF) support
  142.           the appending of sub-images.
  143.  
  144.      The _w, _h, _z and _c values used with the ----pppp, ----ssss and ----oooo options refer to the
  145.      width, height, depth and component dimensions of the image.
  146.  
  147.      The optional index after the input file name is useful on multi-
  148.      resolution images like Photo CD, to select the desired sub-image.  You
  149.      can use imginfo to get a complete list of all sub-images for a given
  150.      file.
  151.  
  152.      The optional format following a file name can be used to specify an
  153.      output file format or to indicate that an image is in raw format.  The
  154.      format_args are format specific.
  155.  
  156. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  157.      To convert an image to the classic SGI format use a command like:
  158.  
  159.           iiiimmmmggggccccooooppppyyyy ssssoooommmmeeeeiiiimmmmaaaaggggeeee....ssssoooommmmeeeeffffoooorrrrmmmmaaaatttt oooouuuuttttiiiimmmmaaaaggggeeee....rrrrggggbbbb
  160.  
  161.      To pick out a 100x100 region starting at (40,50) and write it out as a
  162.      TIFF image file use the command:
  163.  
  164.           iiiimmmmggggccccooooppppyyyy ----ssss 111100000000,,,,111100000000 ----oooo 44440000,,,,55550000 iiiinnnniiiimmmmaaaaggggeeee....rrrrggggbbbb oooouuuuttttiiiimmmmaaaaggggeeee....ttttiiiiffff
  165.  
  166.      To convert an RGB image to greyscale color model use the command:
  167.  
  168.           iiiimmmmggggccccooooppppyyyy ----CCCCggggrrrreeeeyyyy iiiinnnniiiimmmmaaaaggggeeee....rrrrggggbbbb oooouuuuttttiiiimmmmaaaaggggeeee....bbbbwwww
  169.  
  170.      To convert an image to SGI format with no extension on the output file
  171.      name use either command:
  172.  
  173.           iiiimmmmggggccccooooppppyyyy ----ffffssssggggiiii iiiinnnniiiimmmmaaaaggggeeee oooouuuuttttiiiimmmmaaaaggggeeee
  174.  
  175.           iiiimmmmggggccccooooppppyyyy iiiinnnniiiimmmmaaaaggggeeee oooouuuuttttiiiimmmmaaaaggggeeee####ssssggggiiii
  176.  
  177.      To convert the higest resolution sub-image in a Photo CD image to TIFF
  178.      format use the command:
  179.  
  180.           iiiimmmmggggccccooooppppyyyy iiiinnnniiiimmmmaaaaggggeeee....ppppccccdddd::::5555 oooouuuuttttiiiimmmmaaaaggggeeee....ttttiiiiffff
  181.  
  182.      To convert a raw file (with no header information) containing a
  183.      luminance, unsigned char, 512 by 512 image to TIFF format:
  184.  
  185.           iiiimmmmggggccccooooppppyyyy iiiinnnnffffiiiilllleeee####rrrraaaawwww%%%%ssssiiiizzzzeeee====555511112222,,,,555511112222%%%%ccccoooolllloooorrrrmmmmooooddddeeeellll====lllluuuummmmiiiinnnnaaaannnncccceeee oooouuuuttttiiiimmmmaaaaggggeeee....ttttiiiiffff
  186.  
  187. NNNNOOOOTTTTEEEESSSS
  188.      The supported image file formats depend on which file formats are
  189.      currently installed.  The installed formats can be listed with the
  190.      _i_m_g_f_o_r_m_a_t_s(1) command.
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))                                                          IIIIMMMMGGGGCCCCOOOOPPPPYYYY((((1111))))
  203.  
  204.  
  205.  
  206.      The SGI file format ignores most data formatting options; it determines
  207.      what it can support and creates a compatible file as best it can.
  208.  
  209. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  210.      imgview(1), imginfo(1), imgworks(1), imgformats(1)
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.